home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / ths103.zip / LATENEWS.DOC < prev    next >
Text File  |  1993-01-02  |  12KB  |  344 lines
  1.                     Late news on Theseus 1.03
  2.                     -------------------------
  3.  
  4. This file describes changes, additions and clarifications that do
  5. not  appear in  the previous  version of  Theseus manual.  Please
  6. print and read this file prior  to using Theseus, and save it for
  7. future reference.
  8.  
  9.  Summary
  10.  
  11.  0. Release notes
  12.  1. Bugs fixed
  13.  2. New identifiers
  14.  3. New modifiers
  15.  4. New constants
  16.  5. New template markers
  17.  6. Modified existing features
  18.  7. New features
  19.  8. Corrections to the Manual
  20.  
  21. 0. Release notes:
  22.  
  23.    1.01  : The reverse directory scanning.
  24.            The CRC identifier.
  25.  
  26.    1.02  : The context sensitive help system.
  27.            The  scanning  of  self  extracting  compressed  files
  28.                 improved.
  29.  
  30.    1.03  : The ARJ file scanning.
  31.            The EndName identifier.
  32.  
  33.  
  34. 1. Bugs fixed:
  35.   <none>
  36.  
  37.  
  38.  
  39. 2. New identifiers:
  40.                                                            {1.01}
  41. -----------------------------------------------------------------
  42. identifier:             ComprCRC
  43. -----------------------------------------------------------------
  44. abbreviation:           CRC
  45.  
  46. expected value:         Numeric (0-2147483647)
  47.  
  48. supported operators:    = <>
  49.  
  50. purpose:                To check the file CRC
  51.  
  52. comments:               The ComprCRC identifier requires a search
  53.                         into    compressed   archives.    If   no
  54.                         compression   search   option   has  been
  55.                         declared,  THESEUS reports  an error  and
  56.                         the program stops.
  57.  
  58.                         If the CmpOnly  modifier is not declared,
  59.                         CmprCRC  returns a  FALSE value  for each
  60.                         non-compressed file.
  61.                         The  file  CRC  is  usually  displayed in
  62.                         exadecimal format. You can enter a number
  63.                         in  hexadecimal format  using braces (see
  64.                         below).
  65.  
  66.  
  67. example:                THESEUS ZIP CY CRC = [h 36a23eef]
  68.  
  69.  
  70.                                                            {1.03}
  71. -----------------------------------------------------------------
  72. identifier:             EndName
  73. -----------------------------------------------------------------
  74. abbreviation:           EN
  75.  
  76. expected value:         Text
  77.  
  78. supported operators:    = <>
  79.  
  80. purpose:                To check  for a substring  at the end  of
  81.                         the file name.
  82.  
  83. comments:               EndName  works like  NameCont, but checks
  84.                         only for  a substring at  the end of  the
  85.                         file name.
  86.                         EndName  ignores  the  case  size  of the
  87.                         inserted text.
  88.  
  89. example:                THESEUS EndName = ol
  90.                         will match
  91.                                TOOL.DOC
  92.                                GAMEROL.EXE
  93.                                OL.TXT
  94.                                PATROL.OIL
  95.                         and so on,
  96.                         but will ignore
  97.                                TOOLS.DOC
  98.                                GAMEROLE.EXE
  99.                                OLD.TXT
  100.                                PAROLA.OLL
  101.  
  102. 3. New modifiers:
  103.                                                            {1.01}
  104. -----------------------------------------------------------------
  105. modifier:               ReverseDir
  106. -----------------------------------------------------------------
  107. abbreviation:           RVD
  108.  
  109. expected value:         No Value
  110.  
  111. default value:          OFF
  112.  
  113. purpose:                It  inverts the way of the search into
  114.                         subdirectories.
  115.  
  116. comments:               Let's suppose you have the following
  117.                         disk structure:
  118.  
  119.                         C:\ --+
  120.                               |
  121.                               +----+ BC
  122.                                    |
  123.                                    +----+ CLASSLIB
  124.                                    |    |
  125.                                    |    +------- EXAMPLES
  126.                                    |    |
  127.                                    |    +------- LIB
  128.                                    |    |
  129.                                    |    +------- INCLUDE
  130.                                    |
  131.                                    +----  SOURCES
  132.                                    |
  133.                                    +----  DEMOS
  134.  
  135.  
  136.                         If you use a command such as
  137.                         THESEUS PATH = \BC\CLASSLIB NAME=*.CPP
  138.                         the program will process \BC\CLASSLIB and
  139.                         its   subdirectories    (EXAMPLES,   LIB,
  140.                         INCLUDE).
  141.                         Vice versa, declaring ReverseDir, THESEUS
  142.                         will   process   \BC\CLASSLIB   and   its
  143.                         ancestors (BC, C:\).
  144.  
  145.                         Note  that no  recursion is  performed in
  146.                         each subdirectory while processed.
  147.  
  148.                         ReverseDir  change the  behavior of  PATH
  149.                         and PATHEXCLUDE. When you exclude a path,
  150.                         THESEUS will  exclude the given  path and
  151.                         its  descendants.  Using  ReverseDir, the
  152.                         meaning is  that it's excluded  the given
  153.                         path and its ancestors.
  154.  
  155.  
  156. example:
  157.       THESEUS RVD PX=\bc PATH=\bc\classlib\examples name=*.asm
  158.                         THESEUS   will   process   the  following
  159.                         directories:
  160.                         C:\BC\CLASSLIB\EXAMPLES (yes: scanned)
  161.                         C:\BC\CLASSLIB          (yes: scanned)
  162.                         C:\BC                   (no:  skipped)
  163.                         C:\                     (no:  skipped)
  164.  
  165.       THESEUS RVD PATH = \BC name=*.cpp
  166.                         C:\BC                   (yes: scanned)
  167.                         C:\                     (yes: scanned)
  168.  
  169.       THESEUS PATH = \BC name=*.cpp
  170.                         C:\BC                   (yes: scanned)
  171.                         C:\BC\CLASSLIB          (yes: scanned)
  172.                         C:\BC\CLASSLIB\EXAMPLES (yes: scanned)
  173.                         C:\BC\CLASSLIB\LIB      (yes: scanned)
  174.                         C:\BC\CLASSLIB\INCLUDE  (yes: scanned)
  175.                         C:\BC\SOURCES           (yes: scanned)
  176.                         C:\BC\DEMOS             (yes: scanned)
  177.  
  178.  
  179.                                                            {1.02}
  180. -----------------------------------------------------------------
  181. modifier:               Help
  182. -----------------------------------------------------------------
  183. abbreviation:           HE
  184.  
  185. expected value:         Text
  186.  
  187. default value:          <none>
  188.  
  189. purpose:                It  displays  a  short  description  of a
  190.                         given identifier or modifier.
  191.  
  192. comments:               You may insert many  values with a single
  193.                         declaration  of Help,  by separating each
  194.                         value with a semicolon (;).
  195.  
  196.                         Notes:
  197.                         - In  order to obtain  a full description
  198.                           of  identifier purpose,  you must  have
  199.                           the   THESEUS.BIN  data   file  in  the
  200.                           current directory, or  in the DOS path,
  201.                           or in the  same directory where THESEUS
  202.                           starts.
  203.  
  204.                         - The  quick reference  card contained in
  205.                           file  THESEUS.QRC has  been made  using
  206.                           the Help command.  See the QrefCard.TSF
  207.                           script file.
  208.  
  209. example:                THESEUS help=name help=size help=CRC
  210.                         THESEUS help=fcf;fcb;dcf;dcb
  211.  
  212.                                                            {1.03}
  213. -----------------------------------------------------------------
  214. modifier:               ArjExclude
  215. -----------------------------------------------------------------
  216. abbreviation:           JX
  217.  
  218. expected value:         Text
  219.  
  220. default value:          OFF
  221.  
  222. purpose:                It  excludes the ARJ names from scanning.
  223.  
  224. comments:               The same as ZIPEXCLUDE.
  225.  
  226. example:                THESEUS JN=k*.ARJ JX=kr.* size GT 400000
  227.  
  228.  
  229.                                                            {1.03}
  230. -----------------------------------------------------------------
  231. modifier:               ArjNames
  232. -----------------------------------------------------------------
  233. abbreviation:           JN
  234.  
  235. expected value:         Text
  236.  
  237. default value:          none
  238.  
  239. purpose:                It sets the ARJ names to be scanning.
  240.  
  241. comments:               The same as ZIPNAMES.
  242.  
  243. example:                THESEUS JN=k*.ARJ size GT 400000
  244.  
  245.  
  246.                                                            {1.03}
  247. -----------------------------------------------------------------
  248. modifier:               ArjScan
  249. -----------------------------------------------------------------
  250. abbreviation:           ARJ
  251.  
  252. expected value:         No Value
  253.  
  254. default value:          OFF
  255.  
  256. purpose:                It enables THESEUS to search into archive
  257.                         files compressed with ARJ.EXE.
  258.  
  259. comments:               The same as ZIPSCAN.
  260.  
  261. example:                THESEUS ARJ names=*.thj
  262.  
  263. 4. New constants:
  264.   <none>
  265.  
  266.  
  267. 5. New template markers:
  268.                                                            {1.01}
  269.   $CR  = Compressed file CRC
  270.  
  271.  
  272.  
  273. 6. Modified existing features:
  274.                                                            {1.01}
  275.   The output Compressed mask has been changed from
  276.   " $SZ $CZ $RA $DA $TI $AT $ZN"
  277.   to
  278.   " $SZ $CZ $RA $DA $TI $CR $ZN"
  279.  
  280.   So the output compressed template will be expanded as follows:
  281.  
  282.          1         2         3         4         5         6
  283. 12345678901234567890123456789012345678901234567890123456789012345
  284.  ###,###,### ###,###,### ###% www mm/dd/yyyy hh:mmt --CRC--- NAME
  285.    1,234,567     345,678  72% Thu 11/05/1992 09:34p 2c5fe3ba NAME
  286.  
  287.  
  288.                                                            {1.02}
  289.   The error  diagnostic has been enhanced.  When a spelling error
  290.   occurs,  if it's  matter of  wrong use  of a  keyword, a  short
  291.   description of that keyword will be displayed.
  292.   The decription  includes the purpose of  the keyword, like it's
  293.   reported by the HELP modifier.
  294.  
  295.  
  296.                                                            {1.02}
  297.   The search  into compressed, self extracting  archives (ZIP and
  298.   LZH) has  been improved. In  order to make  it faster, THESEUS,
  299.   before scanning a .EXE file, checks  for the existence of a ZIP
  300.   or LZH marker, using the  BegSearch feature. Now, searching for
  301.   a file contained into a self extracting archive is more than 10
  302.   times faster than prior.
  303.   For example, in my computer, (a 386 20Mhz with 4 MB RAM, 120 MB
  304.   Hard Disk [200 Mb with Stacker], 900Kb of Disk cache) there are
  305.   462 EXE files, with 26 Mb of disk space occuped. The command
  306.  
  307.      THESEUS CY ZN=*.exe na=*.*
  308.  
  309.   finds correctly  2 self extracting  files and takes  1'14" with
  310.   the 1.02 version, while takes 10'37" with the previous version!
  311.  
  312.  
  313.  
  314.  
  315. 7. New features:
  316.                                                            {1.01}
  317. Theseus now accepts large numbers in hexadecimal format.
  318. If you insert  a number longer than 2  digits between braces, the
  319. number will  be interpreted as a  number, instead of a  string of
  320. characters.  This feature  is useful  only if  you want to insert
  321. an hexadecimal  number,  because  you  can  insert  a decimal
  322. number without braces.
  323.  
  324. Examples:    [h 3c 3e]
  325.              will be expanded to
  326.              <>
  327.  
  328.              [h100000]
  329.              will be expanded to
  330.              1048576
  331.  
  332.              [h10000]
  333.              will be expanded to
  334.              65536
  335.  
  336.              [12345678]
  337.              will be expanded to
  338.              12345678
  339.  
  340.  
  341.  8. Corrections to the Manual
  342.     The  manual  has  been  rewritten,  in  order  to reflect the
  343.     changes from version 1.00.
  344.